<!DOCTYPE html PUBLIC '-//W3C//DTD XHTML 1.0 Transitional//EN' 'http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd'>
<html xmlns='http://www.w3.org/1999/xhtml'>
<head>
<title>lib/widget/listbox.h</title>
<meta name='robots' content='noindex,nofollow' />
<meta name='generator' content='GLOBAL-6.5.7' />
<meta http-equiv='Content-Style-Type' content='text/css' />
<link rel='stylesheet' type='text/css' href='../style.css' />
</head>
<body>
<!-- beginning of fixed guide -->
<div id='guide'><ul>
<li><a href='#TOP'><img class='icon' src='../icons/first.png' alt='[^]' /></a></li>
<li><a href='#BOTTOM'><img class='icon' src='../icons/last.png' alt='[v]' /></a></li>
<li><a href='#TOP'><img class='icon' src='../icons/top.png' alt='[top]' /></a></li>
<li><a href='#BOTTOM'><img class='icon' src='../icons/bottom.png' alt='[bottom]' /></a></li>
<li><a href='../mains.html'><img class='icon' src='../icons/index.png' alt='[index]' /></a></li>
<li><a href='../help.html'><img class='icon' src='../icons/help.png' alt='[help]' /></a></li>
<li class='standout'><span><a href='../files/lib.html'>lib</a>/<a href='../files/lib--widget.html'>widget</a>/listbox.h</span></li>
</ul></div>
<!-- end of fixed guide -->
<a id='TOP' name='TOP'></a><h2 class='header'><a href='../mains.html'>root</a>/<a href='../files/lib.html'>lib</a>/<a href='../files/lib--widget.html'>widget</a>/listbox.h</h2>
<em class='comment'>/* <img class='icon' src='../icons/n_left.png' alt='[previous]' /><img class='icon' src='../icons/n_right.png' alt='[next]' /><img class='icon' src='../icons/n_first.png' alt='[first]' /><img class='icon' src='../icons/n_last.png' alt='[last]' /><img class='icon' src='../icons/n_top.png' alt='[top]' /><a href='#BOTTOM'><img class='icon' src='../icons/bottom.png' alt='[bottom]' /></a><a href='../mains.html'><img class='icon' src='../icons/index.png' alt='[index]' /></a><a href='../help.html'><img class='icon' src='../icons/help.png' alt='[help]' /></a>&nbsp;<input type='text' readonly onfocus='this.select();' value='+1 lib/widget/listbox.h'  /> */</em>
<hr />
<h2 class='header'><a href='lib--widget.h.html#L32' title='Included from 32 in lib/widget.h.'>INCLUDED FROM</a></h2>
<hr />
<pre>
<a id='L1' name='L1'></a>   1 
<a id='L2' name='L2'></a>   2 <em class='comment'>/** \file listbox.h</em>
<a id='L3' name='L3'></a>   3 <em class='comment'> *  \brief Header: WListbox widget</em>
<a id='L4' name='L4'></a>   4 <em class='comment'> */</em>
<a id='L5' name='L5'></a>   5 
<a id='L6' name='L6'></a>   6 <em class='sharp'>#ifndef</em> <a href='../S/lib--widget--listbox.h.html#L7' title='Defined at 7 in lib/widget/listbox.h.'>MC__WIDGET_LISTBOX_H</a>
<a id='L7' name='L7'></a>   7 <em class='sharp'>#define</em> <a href='../S/lib--widget--listbox.h.html#L6' title='Referred from 6 in lib/widget/listbox.h.'>MC__WIDGET_LISTBOX_H</a>
<a id='L8' name='L8'></a>   8 
<a id='L9' name='L9'></a>   9 <em class='comment'>/*** typedefs(not structures) and defined constants **********************************************/</em>
<a id='L10' name='L10'></a>  10 
<a id='L11' name='L11'></a>  11 <em class='sharp'>#define</em> <a href='../R/LISTBOX.html' title='Multiple referred from 7 places.'>LISTBOX</a>(<a href='../Y/x.html' title='Multiple used in 769 places.'>x</a>) ((<a href='../D/WListbox.html' title='Multiple defined in 2 places.'>WListbox</a> *)(<a href='../Y/x.html' title='Multiple used in 769 places.'>x</a>))
<a id='L12' name='L12'></a>  12 <em class='sharp'>#define</em> <a href='../R/LENTRY.html' title='Multiple referred from 9 places.'>LENTRY</a>(<a href='../Y/x.html' title='Multiple used in 769 places.'>x</a>) ((<a href='../D/WLEntry.html' title='Multiple defined in 2 places.'>WLEntry</a> *)(<a href='../Y/x.html' title='Multiple used in 769 places.'>x</a>))
<a id='L13' name='L13'></a>  13 
<a id='L14' name='L14'></a>  14 <em class='comment'>/*** enums ***************************************************************************************/</em>
<a id='L15' name='L15'></a>  15 
<a id='L16' name='L16'></a>  16 <em class='comment'>/* callback should return one of the following values */</em>
<a id='L17' name='L17'></a>  17 <strong class='reserved'>typedef</strong> <strong class='reserved'>enum</strong>
<a id='L18' name='L18'></a>  18 <em class='brace'>{</em>
<a id='L19' name='L19'></a>  19     <a href='../R/LISTBOX_CONT.html' title='Multiple referred from 2 places.'>LISTBOX_CONT</a>,               <em class='comment'>/* continue */</em>
<a id='L20' name='L20'></a>  20     <a href='../R/LISTBOX_DONE.html' title='Multiple referred from 4 places.'>LISTBOX_DONE</a>                <em class='comment'>/* finish dialog */</em>
<a id='L21' name='L21'></a>  21 <em class='brace'>}</em> <a href='../R/lcback_ret_t.html' title='Multiple referred from 2 places.'>lcback_ret_t</a>;
<a id='L22' name='L22'></a>  22 
<a id='L23' name='L23'></a>  23 <strong class='reserved'>typedef</strong> <strong class='reserved'>enum</strong>
<a id='L24' name='L24'></a>  24 <em class='brace'>{</em>
<a id='L25' name='L25'></a>  25     <a href='../R/LISTBOX_APPEND_AT_END.html' title='Multiple referred from 36 places.'>LISTBOX_APPEND_AT_END</a> = 0,  <em class='comment'>/* append at the end */</em>
<a id='L26' name='L26'></a>  26     <a href='../R/LISTBOX_APPEND_BEFORE.html' title='Multiple referred from 6 places.'>LISTBOX_APPEND_BEFORE</a>,      <em class='comment'>/* insert before current */</em>
<a id='L27' name='L27'></a>  27     <a href='../R/LISTBOX_APPEND_AFTER.html' title='Multiple referred from 5 places.'>LISTBOX_APPEND_AFTER</a>,       <em class='comment'>/* insert after current */</em>
<a id='L28' name='L28'></a>  28     <a href='../R/LISTBOX_APPEND_SORTED.html' title='Multiple referred from 5 places.'>LISTBOX_APPEND_SORTED</a>       <em class='comment'>/* insert alphabetically */</em>
<a id='L29' name='L29'></a>  29 <em class='brace'>}</em> <a href='../R/listbox_append_t.html' title='Multiple referred from 4 places.'>listbox_append_t</a>;
<a id='L30' name='L30'></a>  30 
<a id='L31' name='L31'></a>  31 <em class='comment'>/*** structures declarations (and typedefs of structures)*****************************************/</em>
<a id='L32' name='L32'></a>  32 
<a id='L33' name='L33'></a>  33 <strong class='reserved'>struct</strong> <a href='../D/WListbox.html' title='Multiple defined in 2 places.'>WListbox</a>;
<a id='L34' name='L34'></a>  34 <strong class='reserved'>typedef</strong> <a href='../S/lib--widget--listbox.h.html#L21' title='Defined at 21 in lib/widget/listbox.h.'>lcback_ret_t</a> (*<a href='../Y/lcback_fn.html' title='Multiple used in 4 places.'>lcback_fn</a>) (<strong class='reserved'>struct</strong> <a href='../D/WListbox.html' title='Multiple defined in 2 places.'>WListbox</a> * <a href='../Y/l.html' title='Multiple used in 439 places.'>l</a>);
<a id='L35' name='L35'></a>  35 
<a id='L36' name='L36'></a>  36 <strong class='reserved'>typedef</strong> <strong class='reserved'>struct</strong> <a href='../R/WLEntry.html' title='Multiple referred from 22 places.'>WLEntry</a>
<a id='L37' name='L37'></a>  37 <em class='brace'>{</em>
<a id='L38' name='L38'></a>  38     <strong class='reserved'>char</strong> *<a href='../Y/text.html' title='Multiple used in 945 places.'>text</a>;                 <em class='comment'>/* Text to display */</em>
<a id='L39' name='L39'></a>  39     <strong class='reserved'>int</strong> <a href='../Y/hotkey.html' title='Multiple used in 109 places.'>hotkey</a>;
<a id='L40' name='L40'></a>  40     <strong class='reserved'>void</strong> *<a href='../Y/data.html' title='Multiple used in 912 places.'>data</a>;                 <em class='comment'>/* Client information */</em>
<a id='L41' name='L41'></a>  41     <a href='../Y/gboolean.html' title='Multiple used in 1757 places.'>gboolean</a> <a href='../Y/free_data.html' title='Multiple used in 6 places.'>free_data</a>;         <em class='comment'>/* Whether to free the data on entry's removal */</em>
<a id='L42' name='L42'></a>  42 <em class='brace'>}</em> <a href='../R/WLEntry.html' title='Multiple referred from 22 places.'>WLEntry</a>;
<a id='L43' name='L43'></a>  43 
<a id='L44' name='L44'></a>  44 <strong class='reserved'>typedef</strong> <strong class='reserved'>struct</strong> <a href='../R/WListbox.html' title='Multiple referred from 73 places.'>WListbox</a>
<a id='L45' name='L45'></a>  45 <em class='brace'>{</em>
<a id='L46' name='L46'></a>  46     <a href='../D/Widget.html' title='Multiple defined in 2 places.'>Widget</a> <a href='../Y/widget.html' title='Multiple used in 197 places.'>widget</a>;
<a id='L47' name='L47'></a>  47     <a href='../Y/GQueue.html' title='Multiple used in 9 places.'>GQueue</a> *<a href='../Y/list.html' title='Multiple used in 429 places.'>list</a>;               <em class='comment'>/* Pointer to the list of WLEntry */</em>
<a id='L48' name='L48'></a>  48     <strong class='reserved'>int</strong> <a href='../Y/pos.html' title='Multiple used in 398 places.'>pos</a>;                    <em class='comment'>/* The current element displayed */</em>
<a id='L49' name='L49'></a>  49     <strong class='reserved'>int</strong> <a href='../Y/top.html' title='Multiple used in 103 places.'>top</a>;                    <em class='comment'>/* The first element displayed */</em>
<a id='L50' name='L50'></a>  50     <a href='../Y/gboolean.html' title='Multiple used in 1757 places.'>gboolean</a> <a href='../Y/allow_duplicates.html' title='Multiple used in 3 places.'>allow_duplicates</a>;  <em class='comment'>/* Do we allow duplicates on the list? */</em>
<a id='L51' name='L51'></a>  51     <a href='../Y/gboolean.html' title='Multiple used in 1757 places.'>gboolean</a> <a href='../Y/scrollbar.html' title='Multiple used in 3 places.'>scrollbar</a>;         <em class='comment'>/* Draw a scrollbar? */</em>
<a id='L52' name='L52'></a>  52     <a href='../Y/gboolean.html' title='Multiple used in 1757 places.'>gboolean</a> <a href='../Y/deletable.html' title='Multiple used in 6 places.'>deletable</a>;         <em class='comment'>/* Can list entries be deleted? */</em>
<a id='L53' name='L53'></a>  53     <a href='../Y/lcback_fn.html' title='Multiple used in 4 places.'>lcback_fn</a> <a href='../Y/callback.html' title='Multiple used in 80 places.'>callback</a>;         <em class='comment'>/* The callback function */</em>
<a id='L54' name='L54'></a>  54     <strong class='reserved'>int</strong> cursor_x, <a href='../Y/cursor_y.html' title='Multiple used in 3 places.'>cursor_y</a>;     <em class='comment'>/* Cache the values */</em>
<a id='L55' name='L55'></a>  55 <em class='brace'>}</em> <a href='../R/WListbox.html' title='Multiple referred from 73 places.'>WListbox</a>;
<a id='L56' name='L56'></a>  56 
<a id='L57' name='L57'></a>  57 <em class='comment'>/*** global variables defined in .c file *********************************************************/</em>
<a id='L58' name='L58'></a>  58 
<a id='L59' name='L59'></a>  59 <strong class='reserved'>extern</strong> <strong class='reserved'>const</strong> <a href='../D/global_keymap_t.html' title='Multiple defined in 2 places.'>global_keymap_t</a> *<a href='../Y/listbox_map.html' title='Multiple used in 3 places.'>listbox_map</a>;
<a id='L60' name='L60'></a>  60 
<a id='L61' name='L61'></a>  61 <em class='comment'>/*** declarations of public functions ************************************************************/</em>
<a id='L62' name='L62'></a>  62 
<a id='L63' name='L63'></a>  63 <a href='../D/WListbox.html' title='Multiple defined in 2 places.'>WListbox</a> *<a href='../S/lib--widget--listbox.c.html#L548' title='Defined at 548 in lib/widget/listbox.c.'>listbox_new</a> (<strong class='reserved'>int</strong> <a href='../Y/y.html' title='Multiple used in 658 places.'>y</a>, <strong class='reserved'>int</strong> <a href='../Y/x.html' title='Multiple used in 769 places.'>x</a>, <strong class='reserved'>int</strong> <a href='../Y/height.html' title='Multiple used in 97 places.'>height</a>, <strong class='reserved'>int</strong> <a href='../Y/width.html' title='Multiple used in 278 places.'>width</a>, <a href='../Y/gboolean.html' title='Multiple used in 1757 places.'>gboolean</a> <a href='../Y/deletable.html' title='Multiple used in 6 places.'>deletable</a>, <a href='../Y/lcback_fn.html' title='Multiple used in 4 places.'>lcback_fn</a> <a href='../Y/callback.html' title='Multiple used in 80 places.'>callback</a>);
<a id='L64' name='L64'></a>  64 <strong class='reserved'>int</strong> <a href='../S/lib--widget--listbox.c.html#L578' title='Defined at 578 in lib/widget/listbox.c.'>listbox_search_text</a> (<a href='../D/WListbox.html' title='Multiple defined in 2 places.'>WListbox</a> * <a href='../Y/l.html' title='Multiple used in 439 places.'>l</a>, <strong class='reserved'>const</strong> <strong class='reserved'>char</strong> *<a href='../Y/text.html' title='Multiple used in 945 places.'>text</a>);
<a id='L65' name='L65'></a>  65 <strong class='reserved'>int</strong> <a href='../S/lib--widget--listbox.c.html#L603' title='Defined at 603 in lib/widget/listbox.c.'>listbox_search_data</a> (<a href='../D/WListbox.html' title='Multiple defined in 2 places.'>WListbox</a> * <a href='../Y/l.html' title='Multiple used in 439 places.'>l</a>, <strong class='reserved'>const</strong> <strong class='reserved'>void</strong> *<a href='../Y/data.html' title='Multiple used in 912 places.'>data</a>);
<a id='L66' name='L66'></a>  66 <strong class='reserved'>void</strong> <a href='../S/lib--widget--listbox.c.html#L626' title='Defined at 626 in lib/widget/listbox.c.'>listbox_select_first</a> (<a href='../D/WListbox.html' title='Multiple defined in 2 places.'>WListbox</a> * <a href='../Y/l.html' title='Multiple used in 439 places.'>l</a>);
<a id='L67' name='L67'></a>  67 <strong class='reserved'>void</strong> <a href='../S/lib--widget--listbox.c.html#L635' title='Defined at 635 in lib/widget/listbox.c.'>listbox_select_last</a> (<a href='../D/WListbox.html' title='Multiple defined in 2 places.'>WListbox</a> * <a href='../Y/l.html' title='Multiple used in 439 places.'>l</a>);
<a id='L68' name='L68'></a>  68 <strong class='reserved'>void</strong> <a href='../S/lib--widget--listbox.c.html#L649' title='Defined at 649 in lib/widget/listbox.c.'>listbox_select_entry</a> (<a href='../D/WListbox.html' title='Multiple defined in 2 places.'>WListbox</a> * <a href='../Y/l.html' title='Multiple used in 439 places.'>l</a>, <strong class='reserved'>int</strong> <a href='../Y/dest.html' title='Multiple used in 126 places.'>dest</a>);
<a id='L69' name='L69'></a>  69 <strong class='reserved'>int</strong> <a href='../S/lib--widget--listbox.c.html#L687' title='Defined at 687 in lib/widget/listbox.c.'>listbox_get_length</a> (<strong class='reserved'>const</strong> <a href='../D/WListbox.html' title='Multiple defined in 2 places.'>WListbox</a> * <a href='../Y/l.html' title='Multiple used in 439 places.'>l</a>);
<a id='L70' name='L70'></a>  70 <strong class='reserved'>void</strong> <a href='../S/lib--widget--listbox.c.html#L696' title='Defined at 696 in lib/widget/listbox.c.'>listbox_get_current</a> (<a href='../D/WListbox.html' title='Multiple defined in 2 places.'>WListbox</a> * <a href='../Y/l.html' title='Multiple used in 439 places.'>l</a>, <strong class='reserved'>char</strong> **<a href='../Y/string.html' title='Multiple used in 50 places.'>string</a>, <strong class='reserved'>void</strong> **<a href='../Y/extra.html' title='Multiple used in 20 places.'>extra</a>);
<a id='L71' name='L71'></a>  71 <a href='../D/WLEntry.html' title='Multiple defined in 2 places.'>WLEntry</a> *<a href='../S/lib--widget--listbox.c.html#L716' title='Defined at 716 in lib/widget/listbox.c.'>listbox_get_nth_item</a> (<strong class='reserved'>const</strong> <a href='../D/WListbox.html' title='Multiple defined in 2 places.'>WListbox</a> * <a href='../Y/l.html' title='Multiple used in 439 places.'>l</a>, <strong class='reserved'>int</strong> <a href='../Y/pos.html' title='Multiple used in 398 places.'>pos</a>);
<a id='L72' name='L72'></a>  72 <a href='../Y/GList.html' title='Multiple used in 176 places.'>GList</a> *<a href='../S/lib--widget--listbox.c.html#L733' title='Defined at 733 in lib/widget/listbox.c.'>listbox_get_first_link</a> (<strong class='reserved'>const</strong> <a href='../D/WListbox.html' title='Multiple defined in 2 places.'>WListbox</a> * <a href='../Y/l.html' title='Multiple used in 439 places.'>l</a>);
<a id='L73' name='L73'></a>  73 <strong class='reserved'>void</strong> <a href='../S/lib--widget--listbox.c.html#L741' title='Defined at 741 in lib/widget/listbox.c.'>listbox_remove_current</a> (<a href='../D/WListbox.html' title='Multiple defined in 2 places.'>WListbox</a> * <a href='../Y/l.html' title='Multiple used in 439 places.'>l</a>);
<a id='L74' name='L74'></a>  74 <a href='../Y/gboolean.html' title='Multiple used in 1757 places.'>gboolean</a> <a href='../S/lib--widget--listbox.c.html#L764' title='Defined at 764 in lib/widget/listbox.c.'>listbox_is_empty</a> (<strong class='reserved'>const</strong> <a href='../D/WListbox.html' title='Multiple defined in 2 places.'>WListbox</a> * <a href='../Y/l.html' title='Multiple used in 439 places.'>l</a>);
<a id='L75' name='L75'></a>  75 <strong class='reserved'>void</strong> <a href='../S/lib--widget--listbox.c.html#L778' title='Defined at 778 in lib/widget/listbox.c.'>listbox_set_list</a> (<a href='../D/WListbox.html' title='Multiple defined in 2 places.'>WListbox</a> * <a href='../Y/l.html' title='Multiple used in 439 places.'>l</a>, <a href='../Y/GQueue.html' title='Multiple used in 9 places.'>GQueue</a> * <a href='../Y/list.html' title='Multiple used in 429 places.'>list</a>);
<a id='L76' name='L76'></a>  76 <strong class='reserved'>void</strong> <a href='../S/lib--widget--listbox.c.html#L789' title='Defined at 789 in lib/widget/listbox.c.'>listbox_remove_list</a> (<a href='../D/WListbox.html' title='Multiple defined in 2 places.'>WListbox</a> * <a href='../Y/l.html' title='Multiple used in 439 places.'>l</a>);
<a id='L77' name='L77'></a>  77 <strong class='reserved'>char</strong> *<a href='../S/lib--widget--listbox.c.html#L806' title='Defined at 806 in lib/widget/listbox.c.'>listbox_add_item</a> (<a href='../D/WListbox.html' title='Multiple defined in 2 places.'>WListbox</a> * <a href='../Y/l.html' title='Multiple used in 439 places.'>l</a>, <a href='../S/lib--widget--listbox.h.html#L29' title='Defined at 29 in lib/widget/listbox.h.'>listbox_append_t</a> <a href='../Y/pos.html' title='Multiple used in 398 places.'>pos</a>, <strong class='reserved'>int</strong> <a href='../Y/hotkey.html' title='Multiple used in 109 places.'>hotkey</a>, <strong class='reserved'>const</strong> <strong class='reserved'>char</strong> *<a href='../Y/text.html' title='Multiple used in 945 places.'>text</a>,
<a id='L78' name='L78'></a>  78                         <strong class='reserved'>void</strong> *<a href='../Y/data.html' title='Multiple used in 912 places.'>data</a>, <a href='../Y/gboolean.html' title='Multiple used in 1757 places.'>gboolean</a> <a href='../Y/free_data.html' title='Multiple used in 6 places.'>free_data</a>);
<a id='L79' name='L79'></a>  79 
<a id='L80' name='L80'></a>  80 <em class='comment'>/*** inline functions ****************************************************************************/</em>
<a id='L81' name='L81'></a>  81 
<a id='L82' name='L82'></a>  82 <em class='sharp'>#endif</em> <em class='comment'>/* MC__WIDGET_LISTBOX_H */</em>
</pre>
<hr />
<a id='BOTTOM' name='BOTTOM'></a>
<em class='comment'>/* <img class='icon' src='../icons/n_left.png' alt='[previous]' /><img class='icon' src='../icons/n_right.png' alt='[next]' /><img class='icon' src='../icons/n_first.png' alt='[first]' /><img class='icon' src='../icons/n_last.png' alt='[last]' /><a href='#TOP'><img class='icon' src='../icons/top.png' alt='[top]' /></a><img class='icon' src='../icons/n_bottom.png' alt='[bottom]' /><a href='../mains.html'><img class='icon' src='../icons/index.png' alt='[index]' /></a><a href='../help.html'><img class='icon' src='../icons/help.png' alt='[help]' /></a>&nbsp;<input type='text' readonly onfocus='this.select();' value='+82 lib/widget/listbox.h'  /> */</em>
</body>
</html>
